[Top] [Prev] [Next] [Bottom] [Contents]

SaDestroyLocalBuffers

Frees the local ring buffer.

Synopsis

#include "SaPopCalls.h"
void SaDestroyLocalBuffers();

Arguments

None.

Return Values

None.

Description

SaDestroyLocalBuffers will delete the entire ring buffer and free all of the strings in it.

This would have the effect of restarting the ring buffer from scratch.

The ring buffer is a list of up to 10 strings. When an eleventh item is added to it, the first item is removed and free'd and the eleventh item is appended to the end of the ring buffer. This makes sure that functions using the ring buffer can be called nine times before buffers are free'd and therefore become invalid.

This is used primarily with Widget Data Extraction functions that are embedded in other functions requiring character pointers. This eliminates the need to free a returned string since it will be free'd automatically.

See Also



[Top] [Prev] [Next] [Bottom] [Contents]

info@bluestone.com
Copyright © 1997, Bluestone. All rights reserved.